'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\" $RCSfile: accounting.5,v $     Last Update: $Date: 2008/12/23 16:51:59 $     Revision: $Revision: 1.17 $
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB		\" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\"
.de T		\" switch to typewriter font
.ft CW		\" probably want CW if you don't have TA font
..
.\"
.de TY		\" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M		\" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH ACCOUNTING 5 "$Date: 2008/12/23 16:51:59 $" "xxRELxx" "xxQS_NAMExx File Formats"
.\"
.SH NAME
accounting \- xxQS_NAMExx accounting file format
.\"
.SH DESCRIPTION
An accounting record is written to the xxQS_NAMExx
accounting file for each job having finished. The accounting file is
processed by
.M qacct 1
to derive accounting statistics.
.\"
.\"
.SH FORMAT
Each job is represented by a line in the accounting file. Empty lines
and lines which contain one character or less are ignored.
Accounting record entries are
separated by colon (':') signs. The entries denote in their order
of appearance:
.SS "\fBqname\fP"
Name of the cluster queue in which the job has run.
.SS "\fBhostname\fP"
Name of the execution host.
.SS "\fBgroup\fP"
The effective group id of the job owner when executing the job.
.SS "\fBowner\fP"
Owner of the xxQS_NAMExx job.
.SS "\fBjob_name\fP"
Job name.
.SS "\fBjob_number\fP"
Job identifier - job number.
.SS "\fBaccount\fP"
An account string as specified by the
.M qsub 1
or
.M qalter 1
\fB\-A\fP option.
.SS "\fBpriority\fP"
Priority value assigned to the job corresponding to the \fBpriority\fP
parameter in the queue configuration (see
.M queue_conf 5 ).
.SS "\fBsubmission_time\fP"
Submission time (GMT unix time stamp).
.SS "\fBstart_time\fP"
Start time (GMT unix time stamp).
.SS "\fBend_time\fP"
End time (GMT unix time stamp).
.SS "\fBfailed\fP"
Indicates the problem which occurred in case a job could not be started on 
the execution host (e.g. because the owner of the job did not have a valid 
account on that machine). If xxQS_NAMExx tries to start a job multiple times, 
this may lead to multiple entries in the accounting file corresponding to 
the same job ID.
.SS "\fBexit_status\fP"
Exit status of the job script (or xxQS_NAMExx specific status in case
of certain error conditions).
The exit status is determined by following the normal shell conventions.
If the command terminates normally the value of the command is its exit status.
However, in the case that the command exits abnormally, a value of 0200 (octal), 
128 (decimal) is added to the value of the command to make up the exit status.
.P
.RS
For example: If a job dies through signal 9 (SIGKILL) then the exit status 
becomes 128 + 9 = 137.
.RE
.SS "\fBru_wallclock\fP"
Difference between \fBend_time\fP and \fBstart_time\fP (see above).
.PP
The remainder of the accounting entries follows the contents of the
standard UNIX rusage structure as described in
.M getrusage 2 .
Depending on the operating system where the job was executed some of the
fields may be 0.  The following entries are provided:
.PP
.nf
.RS
.B ru_utime
.B ru_stime
.B ru_maxrss
.B ru_ixrss
.B ru_ismrss
.B ru_idrss
.B ru_isrss
.B ru_minflt
.B ru_majflt
.B ru_nswap
.B ru_inblock
.B ru_oublock
.B ru_msgsnd
.B ru_msgrcv
.B ru_nsignals
.B ru_nvcsw
.B ru_nivcsw
.RE
.fi
.PP

.SS "\fBproject\fP"
The project which was assigned to the job.
.SS "\fBdepartment\fP"
The department which was assigned to the job.
.SS "\fBgranted_pe\fP"
The parallel environment which was selected for that job.
.SS "\fBslots\fP"
The number of slots which were dispatched to the job by the scheduler.
.SS "\fBtask_number\fP"
Array job task index number.
.SS "\fBcpu\fP"
The cpu time usage in seconds. 
.SS "\fBmem\fP"
The integral memory usage in Gbytes cpu seconds. 
.SS "\fBio\fP"
The amount of data transferred in input/output operations.
.SS "\fBcategory\fP"
A string specifying the job category.
.SS "\fBiow\fP"
The io wait time in seconds.
.SS "\fBpe_taskid\fP"
If this identifier is set the task was part of a parallel job and was 
passed to xxQS_NAMExx via the qrsh -inherit interface.
.SS "\fBmaxvmem\fP"
The maximum vmem size in bytes.
.SS "\fBarid\fP"
Advance reservation identifier. If the job used resources of an advance
reservation then this field contains a positive integer identifier otherwise the
value is "\fB0\fP" .
.SS "\fBar_submission_time\fP"
If the job used resources of an advance reservation then this field contains the submission time (GMT unix time stamp) of the advance reservation, otherwise the value is "\fB0\fP" .
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M qacct 1 ,
.M qalter 1 ,
.M qsub 1 ,
.M getrusage 2 ,
.M queue_conf 5 .
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.
